<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
<html><head><title>QWebElement Class Reference</title><style>h3.fn,span.fn { margin-left: 1cm; text-indent: -1cm }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
td.postheader { font-family: sans-serif }
tr.address { font-family: sans-serif }
body { background: #ffffff; color: black; }
</style></head><body><table border="0" cellpadding="0" cellspacing="0" width="100%"><tr /><td align="left" valign="top" width="32"><img align="left" border="0" height="32" src="images/rb-logo.png" width="32" /></td><td width="1">&#160;&#160;</td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">Home</font></a>&#160;&#183; <a href="classes.html"><font color="#004faf">All Classes</font></a>&#160;&#183; <a href="modules.html"><font color="#004faf">Modules</font></a></td></table><h1 align="center">QWebElement Class Reference<br /><sup><sup>[<a href="qtwebkit.html">QtWebKit</a> module]</sup></sup></h1><p>The QWebElement class provides convenient access to DOM elements
in a <a href="qwebframe.html">QWebFrame</a>. <a href="#details">More...</a></p>

<h3>Types</h3><ul><li><div class="fn" />enum <b><a href="qwebelement.html#StyleResolveStrategy-enum">StyleResolveStrategy</a></b> { InlineStyle, CascadedStyle, ComputedStyle }</li></ul><h3>Methods</h3><ul><li><div class="fn" /><b><a href="qwebelement.html#QWebElement">__init__</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#QWebElement-2">__init__</a></b> (<i>self</i>, QWebElement)</li><li><div class="fn" /><b><a href="qwebelement.html#addClass">addClass</a></b> (<i>self</i>, QString&#160;<i>name</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#appendInside">appendInside</a></b> (<i>self</i>, QString&#160;<i>markup</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#appendInside-2">appendInside</a></b> (<i>self</i>, QWebElement&#160;<i>element</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#appendOutside">appendOutside</a></b> (<i>self</i>, QString&#160;<i>markup</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#appendOutside-2">appendOutside</a></b> (<i>self</i>, QWebElement&#160;<i>element</i>)</li><li><div class="fn" />QString <b><a href="qwebelement.html#attribute">attribute</a></b> (<i>self</i>, QString&#160;<i>name</i>, QString&#160;<i>defaultValue</i>&#160;=&#160;QString())</li><li><div class="fn" />QStringList <b><a href="qwebelement.html#attributeNames">attributeNames</a></b> (<i>self</i>, QString&#160;<i>namespaceUri</i>&#160;=&#160;QString())</li><li><div class="fn" />QString <b><a href="qwebelement.html#attributeNS">attributeNS</a></b> (<i>self</i>, QString&#160;<i>namespaceUri</i>, QString&#160;<i>name</i>, QString&#160;<i>defaultValue</i>&#160;=&#160;QString())</li><li><div class="fn" />QStringList <b><a href="qwebelement.html#classes">classes</a></b> (<i>self</i>)</li><li><div class="fn" />QWebElement <b><a href="qwebelement.html#clone">clone</a></b> (<i>self</i>)</li><li><div class="fn" />QWebElement <b><a href="qwebelement.html#document">document</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#encloseContentsWith">encloseContentsWith</a></b> (<i>self</i>, QWebElement&#160;<i>element</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#encloseContentsWith-2">encloseContentsWith</a></b> (<i>self</i>, QString&#160;<i>markup</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#encloseWith">encloseWith</a></b> (<i>self</i>, QString&#160;<i>markup</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#encloseWith-2">encloseWith</a></b> (<i>self</i>, QWebElement&#160;<i>element</i>)</li><li><div class="fn" />QVariant <b><a href="qwebelement.html#evaluateJavaScript">evaluateJavaScript</a></b> (<i>self</i>, QString&#160;<i>scriptSource</i>)</li><li><div class="fn" />QWebElementCollection <b><a href="qwebelement.html#findAll">findAll</a></b> (<i>self</i>, QString&#160;<i>selectorQuery</i>)</li><li><div class="fn" />QWebElement <b><a href="qwebelement.html#findFirst">findFirst</a></b> (<i>self</i>, QString&#160;<i>selectorQuery</i>)</li><li><div class="fn" />QWebElement <b><a href="qwebelement.html#firstChild">firstChild</a></b> (<i>self</i>)</li><li><div class="fn" />QRect <b><a href="qwebelement.html#geometry">geometry</a></b> (<i>self</i>)</li><li><div class="fn" />bool <b><a href="qwebelement.html#hasAttribute">hasAttribute</a></b> (<i>self</i>, QString&#160;<i>name</i>)</li><li><div class="fn" />bool <b><a href="qwebelement.html#hasAttributeNS">hasAttributeNS</a></b> (<i>self</i>, QString&#160;<i>namespaceUri</i>, QString&#160;<i>name</i>)</li><li><div class="fn" />bool <b><a href="qwebelement.html#hasAttributes">hasAttributes</a></b> (<i>self</i>)</li><li><div class="fn" />bool <b><a href="qwebelement.html#hasClass">hasClass</a></b> (<i>self</i>, QString&#160;<i>name</i>)</li><li><div class="fn" />bool <b><a href="qwebelement.html#hasFocus">hasFocus</a></b> (<i>self</i>)</li><li><div class="fn" />bool <b><a href="qwebelement.html#isNull">isNull</a></b> (<i>self</i>)</li><li><div class="fn" />QWebElement <b><a href="qwebelement.html#lastChild">lastChild</a></b> (<i>self</i>)</li><li><div class="fn" />QString <b><a href="qwebelement.html#localName">localName</a></b> (<i>self</i>)</li><li><div class="fn" />QString <b><a href="qwebelement.html#namespaceUri">namespaceUri</a></b> (<i>self</i>)</li><li><div class="fn" />QWebElement <b><a href="qwebelement.html#nextSibling">nextSibling</a></b> (<i>self</i>)</li><li><div class="fn" />QWebElement <b><a href="qwebelement.html#parent">parent</a></b> (<i>self</i>)</li><li><div class="fn" />QString <b><a href="qwebelement.html#prefix">prefix</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#prependInside">prependInside</a></b> (<i>self</i>, QString&#160;<i>markup</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#prependInside-2">prependInside</a></b> (<i>self</i>, QWebElement&#160;<i>element</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#prependOutside">prependOutside</a></b> (<i>self</i>, QString&#160;<i>markup</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#prependOutside-2">prependOutside</a></b> (<i>self</i>, QWebElement&#160;<i>element</i>)</li><li><div class="fn" />QWebElement <b><a href="qwebelement.html#previousSibling">previousSibling</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#removeAllChildren">removeAllChildren</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#removeAttribute">removeAttribute</a></b> (<i>self</i>, QString&#160;<i>name</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#removeAttributeNS">removeAttributeNS</a></b> (<i>self</i>, QString&#160;<i>namespaceUri</i>, QString&#160;<i>name</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#removeClass">removeClass</a></b> (<i>self</i>, QString&#160;<i>name</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#removeFromDocument">removeFromDocument</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#render">render</a></b> (<i>self</i>, QPainter&#160;<i>painter</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#replace">replace</a></b> (<i>self</i>, QString&#160;<i>markup</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#replace-2">replace</a></b> (<i>self</i>, QWebElement&#160;<i>element</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#setAttribute">setAttribute</a></b> (<i>self</i>, QString&#160;<i>name</i>, QString&#160;<i>value</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#setAttributeNS">setAttributeNS</a></b> (<i>self</i>, QString&#160;<i>namespaceUri</i>, QString&#160;<i>name</i>, QString&#160;<i>value</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#setFocus">setFocus</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#setInnerXml">setInnerXml</a></b> (<i>self</i>, QString&#160;<i>markup</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#setOuterXml">setOuterXml</a></b> (<i>self</i>, QString&#160;<i>markup</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#setPlainText">setPlainText</a></b> (<i>self</i>, QString&#160;<i>text</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#setStyleProperty">setStyleProperty</a></b> (<i>self</i>, QString&#160;<i>name</i>, QString&#160;<i>value</i>)</li><li><div class="fn" />QString <b><a href="qwebelement.html#styleProperty">styleProperty</a></b> (<i>self</i>, QString&#160;<i>name</i>, StyleResolveStrategy&#160;<i>strategy</i>)</li><li><div class="fn" />QString <b><a href="qwebelement.html#tagName">tagName</a></b> (<i>self</i>)</li><li><div class="fn" />QWebElement <b><a href="qwebelement.html#takeFromDocument">takeFromDocument</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qwebelement.html#toggleClass">toggleClass</a></b> (<i>self</i>, QString&#160;<i>name</i>)</li><li><div class="fn" />QString <b><a href="qwebelement.html#toInnerXml">toInnerXml</a></b> (<i>self</i>)</li><li><div class="fn" />QString <b><a href="qwebelement.html#toOuterXml">toOuterXml</a></b> (<i>self</i>)</li><li><div class="fn" />QString <b><a href="qwebelement.html#toPlainText">toPlainText</a></b> (<i>self</i>)</li><li><div class="fn" />QWebFrame <b><a href="qwebelement.html#webFrame">webFrame</a></b> (<i>self</i>)</li></ul><h3>Special Methods</h3><ul><li><div class="fn" />bool <b><a href="qwebelement.html#__eq__">__eq__</a></b> (<i>self</i>, QWebElement&#160;<i>o</i>)</li><li><div class="fn" />bool <b><a href="qwebelement.html#__ne__">__ne__</a></b> (<i>self</i>, QWebElement&#160;<i>o</i>)</li></ul><a name="details" /><hr /><h2>Detailed Description</h2><p>The QWebElement class provides convenient access to DOM elements
in a <a href="qwebframe.html">QWebFrame</a>.</p>
<p>A QWebElement object allows easy access to the document model,
represented by a tree-like structure of DOM elements. The root of
the tree is called the document element and can be accessed using
<a href="qwebframe.html#documentElement">QWebFrame.documentElement</a>().</p>
<p>Specific elements can be accessed using <a href="qwebelement.html#findAll">findAll</a>() and <a href="qwebelement.html#findFirst">findFirst</a>(). These elements are
identified using CSS selectors. The code snippet below demonstrates
the use of <a href="qwebelement.html#findAll">findAll</a>().</p>
<pre class="cpp">
     <span class="type">QWebElement</span> document <span class="operator">=</span> frame<span class="operator">-</span><span class="operator">&gt;</span>documentElement();
     <span class="comment">/* Assume the document has the following structure:

        &lt;p class=intro&gt;
          &lt;span&gt;Intro&lt;/span&gt;
          &lt;span&gt;Snippets&lt;/span&gt;
        &lt;/p&gt;
        &lt;p&gt;
          &lt;span&gt;Content&lt;/span&gt;
          &lt;span&gt;Here&lt;/span&gt;
        &lt;/p&gt;
     */</span>

     <span class="type"><a href="qwebelementcollection.html">QWebElementCollection</a></span> allSpans <span class="operator">=</span> document<span class="operator">.</span>findAll(<span class="string">"span"</span>);
     <span class="type"><a href="qwebelementcollection.html">QWebElementCollection</a></span> introSpans <span class="operator">=</span> document<span class="operator">.</span>findAll(<span class="string">"p.intro span"</span>);
</pre>
<p>The first list contains all <tt>span</tt> elements in the
document. The second list contains <tt>span</tt> elements that are
children of <tt>p</tt>, classified with <tt>intro</tt>.</p>
<p>Using <a href="qwebelement.html#findFirst">findFirst</a>() is
more efficient than calling <a href="qwebelement.html#findAll">findAll</a>(), and extracting the first
element only in the list returned.</p>
<p>Alternatively you can traverse the document manually using
<a href="qwebelement.html#firstChild">firstChild</a>() and <a href="qwebelement.html#nextSibling">nextSibling</a>():</p>
<pre class="cpp">
     frame<span class="operator">-</span><span class="operator">&gt;</span>setHtml(<span class="string">"&lt;html&gt;&lt;body&gt;&lt;p&gt;First Paragraph&lt;/p&gt;&lt;p&gt;Second Paragraph&lt;/p&gt;&lt;/body&gt;&lt;/html&gt;"</span>);
     <span class="type">QWebElement</span> doc <span class="operator">=</span> frame<span class="operator">-</span><span class="operator">&gt;</span>documentElement();
     <span class="type">QWebElement</span> body <span class="operator">=</span> doc<span class="operator">.</span>firstChild();
     <span class="type">QWebElement</span> firstParagraph <span class="operator">=</span> body<span class="operator">.</span>firstChild();
     <span class="type">QWebElement</span> secondParagraph <span class="operator">=</span> firstParagraph<span class="operator">.</span>nextSibling();
</pre>
<p>Individual elements can be inspected or changed using methods
such as <a href="qwebelement.html#attribute">attribute</a>() or
<a href="qwebelement.html#setAttribute">setAttribute</a>(). For
examle, to capture the user's input in a text field for later use
(auto-completion), a browser could do something like this:</p>
<pre class="cpp">
     <span class="type">QWebElement</span> firstTextInput <span class="operator">=</span> document<span class="operator">.</span>findFirst(<span class="string">"input[type=text]"</span>);
     <span class="type"><a href="qstring.html">QString</a></span> storedText <span class="operator">=</span> firstTextInput<span class="operator">.</span>attribute(<span class="string">"value"</span>);
</pre>
<p>When the same page is later revisited, the browser can fill in
the text field automatically by modifying the value attribute of
the input element:</p>
<pre class="cpp">
     <span class="type">QWebElement</span> firstTextInput <span class="operator">=</span> document<span class="operator">.</span>findFirst(<span class="string">"input[type=text]"</span>);
     textInput<span class="operator">.</span>setAttribute(<span class="string">"value"</span><span class="operator">,</span> storedText);
</pre>
<p>Another use case is to emulate a click event on an element. The
following code snippet demonstrates how to call the JavaScript DOM
method click() of a submit button:</p>
<pre class="cpp">
     <span class="type">QWebElement</span> document <span class="operator">=</span> frame<span class="operator">-</span><span class="operator">&gt;</span>documentElement();
     <span class="comment">/* Assume that the document has the following structure:

         &lt;form name="myform" action="submit_form.asp" method="get"&gt;
             &lt;input type="text" name="myfield"&gt;
             &lt;input type="submit" value="Submit"&gt;
         &lt;/form&gt;

      */</span>

     <span class="type">QWebElement</span> button <span class="operator">=</span> document<span class="operator">.</span>findFirst(<span class="string">"input[type=submit]"</span>);
     button<span class="operator">.</span>evaluateJavaScript(<span class="string">"this.click()"</span>);
</pre>
<p>The underlying content of QWebElement is explicitly shared.
Creating a copy of a QWebElement does not create a copy of the
content. Instead, both instances point to the same element.</p>
<p>The contents of child elements can be converted to plain text
with <a href="qwebelement.html#toPlainText">toPlainText</a>(); to
XHTML using <a href="qwebelement.html#toInnerXml">toInnerXml</a>().
To include the element's tag in the output, use <a href="qwebelement.html#toOuterXml">toOuterXml</a>().</p>
<p>It is possible to replace the contents of child elements using
<a href="qwebelement.html#setPlainText">setPlainText</a>() and
<a href="qwebelement.html#setInnerXml">setInnerXml</a>(). To
replace the element itself and its contents, use <a href="qwebelement.html#setOuterXml">setOuterXml</a>().</p>
<a id="examples" name="examples" />
<h3>Examples</h3>
<p>The <a href="webkit-domtraversal.html">DOM Traversal Example</a>
shows one way to traverse documents in a running example.</p>
<p>The <a href="webkit-simpleselector.html">Simple Selector
Example</a> can be used to experiment with the searching features
of this class and provides sample code you can start working
with.</p>
<hr /><h2>Type Documentation</h2><h3 class="fn"><a name="StyleResolveStrategy-enum" />QWebElement.StyleResolveStrategy</h3><p>This enum describes how <a href="qwebelement.html">QWebElement</a>'s styleProperty resolves the
given property name.</p>
<table class="valuelist">
<tr class="odd" valign="top">
<th class="tblConst">Constant</th>
<th class="tblval">Value</th>
<th class="tbldscr">Description</th>
</tr>
<tr>
<td class="topAlign"><tt>QWebElement.InlineStyle</tt></td>
<td class="topAlign"><tt>0</tt></td>
<td class="topAlign">Return the property value as it is defined in
the element, without respecting style inheritance and other CSS
rules.</td>
</tr>
<tr>
<td class="topAlign"><tt>QWebElement.CascadedStyle</tt></td>
<td class="topAlign"><tt>1</tt></td>
<td class="topAlign">The property's value is determined using the
inheritance and importance rules defined in the document's
stylesheet.</td>
</tr>
<tr>
<td class="topAlign"><tt>QWebElement.ComputedStyle</tt></td>
<td class="topAlign"><tt>2</tt></td>
<td class="topAlign">The property's value is the absolute value of
the style property resolved from the environment.</td>
</tr>
</table>
<hr /><h2>Method Documentation</h2><h3 class="fn"><a name="QWebElement" />QWebElement.__init__ (<i>self</i>)</h3><p>Constructs a null web element.</p>


<h3 class="fn"><a name="QWebElement-2" />QWebElement.__init__ (<i>self</i>, <a href="qwebelement.html">QWebElement</a>)</h3><p>Constructs a copy of <i>other</i>.</p>


<h3 class="fn"><a name="addClass" />QWebElement.addClass (<i>self</i>, QString&#160;<i>name</i>)</h3><p>Adds the specified class with the given <i>name</i> to the
element.</p>


<h3 class="fn"><a name="appendInside" />QWebElement.appendInside (<i>self</i>, QString&#160;<i>markup</i>)</h3><p>Appends the result of parsing <i>markup</i> as the element's
last child.</p>
<p>Calling this function on a null element does nothing.</p>
<p><b>See also</b> <a href="qwebelement.html#prependInside">prependInside</a>(), <a href="qwebelement.html#prependOutside">prependOutside</a>(), and
<a href="qwebelement.html#appendOutside">appendOutside</a>().</p>


<h3 class="fn"><a name="appendInside-2" />QWebElement.appendInside (<i>self</i>, <a href="qwebelement.html">QWebElement</a>&#160;<i>element</i>)</h3><p>Appends the given <i>element</i> as the element's last
child.</p>
<p>If <i>element</i> is the child of another element, it is
re-parented to this element. If <i>element</i> is a child of this
element, then its position in the list of children is changed.</p>
<p>Calling this function on a null element does nothing.</p>
<p><b>See also</b> <a href="qwebelement.html#prependInside">prependInside</a>(), <a href="qwebelement.html#prependOutside">prependOutside</a>(), and
<a href="qwebelement.html#appendOutside">appendOutside</a>().</p>


<h3 class="fn"><a name="appendOutside" />QWebElement.appendOutside (<i>self</i>, QString&#160;<i>markup</i>)</h3><p>Inserts the result of parsing <i>markup</i> after this
element.</p>
<p>Calling this function on a null element does nothing.</p>
<p><b>See also</b> <a href="qwebelement.html#appendInside">appendInside</a>(), <a href="qwebelement.html#prependInside">prependInside</a>(), and <a href="qwebelement.html#prependOutside">prependOutside</a>().</p>


<h3 class="fn"><a name="appendOutside-2" />QWebElement.appendOutside (<i>self</i>, <a href="qwebelement.html">QWebElement</a>&#160;<i>element</i>)</h3><p>Inserts the given <i>element</i> after this element.</p>
<p>If <i>element</i> is the child of another element, it is
re-parented to the parent of this element.</p>
<p>Calling this function on a null element does nothing.</p>
<p><b>See also</b> <a href="qwebelement.html#appendInside">appendInside</a>(), <a href="qwebelement.html#prependInside">prependInside</a>(), and <a href="qwebelement.html#prependOutside">prependOutside</a>().</p>


<h3 class="fn"><a name="attribute" />QString QWebElement.attribute (<i>self</i>, QString&#160;<i>name</i>, QString&#160;<i>defaultValue</i>&#160;=&#160;QString())</h3><p>Returns the attribute with the given <i>name</i>. If the
attribute does not exist, <i>defaultValue</i> is returned.</p>
<p><b>See also</b> <a href="qwebelement.html#setAttribute">setAttribute</a>(), <a href="qwebelement.html#setAttributeNS">setAttributeNS</a>(), and
<a href="qwebelement.html#attributeNS">attributeNS</a>().</p>


<h3 class="fn"><a name="attributeNames" />QStringList QWebElement.attributeNames (<i>self</i>, QString&#160;<i>namespaceUri</i>&#160;=&#160;QString())</h3><p>Return the list of attributes for the namespace given as
<i>namespaceUri</i>.</p>
<p><b>See also</b> <a href="qwebelement.html#attribute">attribute</a>() and <a href="qwebelement.html#setAttribute">setAttribute</a>().</p>


<h3 class="fn"><a name="attributeNS" />QString QWebElement.attributeNS (<i>self</i>, QString&#160;<i>namespaceUri</i>, QString&#160;<i>name</i>, QString&#160;<i>defaultValue</i>&#160;=&#160;QString())</h3><p>Returns the attribute with the given <i>name</i> in
<i>namespaceUri</i>. If the attribute does not exist,
<i>defaultValue</i> is returned.</p>
<p><b>See also</b> <a href="qwebelement.html#setAttributeNS">setAttributeNS</a>(), <a href="qwebelement.html#setAttribute">setAttribute</a>(), and <a href="qwebelement.html#attribute">attribute</a>().</p>


<h3 class="fn"><a name="classes" />QStringList QWebElement.classes (<i>self</i>)</h3><p>Returns the list of classes of this element.</p>


<h3 class="fn"><a name="clone" /><a href="qwebelement.html">QWebElement</a> QWebElement.clone (<i>self</i>)</h3><p>Returns a clone of this element.</p>
<p>The clone may be inserted at any point in the document.</p>
<p><b>See also</b> <a href="qwebelement.html#appendInside">appendInside</a>(), <a href="qwebelement.html#prependInside">prependInside</a>(), <a href="qwebelement.html#prependOutside">prependOutside</a>(), and
<a href="qwebelement.html#appendOutside">appendOutside</a>().</p>


<h3 class="fn"><a name="document" /><a href="qwebelement.html">QWebElement</a> QWebElement.document (<i>self</i>)</h3><p>Returns the document which this element belongs to.</p>


<h3 class="fn"><a name="encloseContentsWith" />QWebElement.encloseContentsWith (<i>self</i>, <a href="qwebelement.html">QWebElement</a>&#160;<i>element</i>)</h3><p>Encloses the contents of this element with <i>element</i>. This
element becomes the child of the deepest descendant within
<i>element</i>.</p>
<p>### illustration</p>
<p><b>See also</b> <a href="qwebelement.html#encloseWith">encloseWith</a>().</p>


<h3 class="fn"><a name="encloseContentsWith-2" />QWebElement.encloseContentsWith (<i>self</i>, QString&#160;<i>markup</i>)</h3><p>Encloses the contents of this element with the result of parsing
<i>markup</i>. This element becomes the child of the deepest
descendant within <i>markup</i>.</p>
<p><b>See also</b> <a href="qwebelement.html#encloseWith">encloseWith</a>().</p>


<h3 class="fn"><a name="encloseWith" />QWebElement.encloseWith (<i>self</i>, QString&#160;<i>markup</i>)</h3><p>Encloses this element with the result of parsing <i>markup</i>.
This element becomes the child of the deepest descendant within
<i>markup</i>.</p>
<p><b>See also</b> <a href="qwebelement.html#replace">replace</a>().</p>


<h3 class="fn"><a name="encloseWith-2" />QWebElement.encloseWith (<i>self</i>, <a href="qwebelement.html">QWebElement</a>&#160;<i>element</i>)</h3><p>Encloses this element with <i>element</i>. This element becomes
the child of the deepest descendant within <i>element</i>.</p>
<p><b>See also</b> <a href="qwebelement.html#replace">replace</a>().</p>


<h3 class="fn"><a name="evaluateJavaScript" />QVariant QWebElement.evaluateJavaScript (<i>self</i>, QString&#160;<i>scriptSource</i>)</h3><p>Executes <i>scriptSource</i> with this element as <tt>this</tt>
object.</p>


<h3 class="fn"><a name="findAll" /><a href="qwebelementcollection.html">QWebElementCollection</a> QWebElement.findAll (<i>self</i>, QString&#160;<i>selectorQuery</i>)</h3><p>Returns a new list of child elements matching the given CSS
selector <i>selectorQuery</i>. If there are no matching elements,
an empty list is returned.</p>
<p><a href="http://www.w3.org/TR/REC-CSS2/selector.html#q1">Standard CSS2
selector</a> syntax is used for the query.</p>
<p><b>Note:</b> This search is performed recursively.</p>
<p><b>See also</b> <a href="qwebelement.html#findFirst">findFirst</a>().</p>


<h3 class="fn"><a name="findFirst" /><a href="qwebelement.html">QWebElement</a> QWebElement.findFirst (<i>self</i>, QString&#160;<i>selectorQuery</i>)</h3><p>Returns the first child element that matches the given CSS
selector <i>selectorQuery</i>.</p>
<p><a href="http://www.w3.org/TR/REC-CSS2/selector.html#q1">Standard CSS2
selector</a> syntax is used for the query.</p>
<p><b>Note:</b> This search is performed recursively.</p>
<p><b>See also</b> <a href="qwebelement.html#findAll">findAll</a>().</p>


<h3 class="fn"><a name="firstChild" /><a href="qwebelement.html">QWebElement</a> QWebElement.firstChild (<i>self</i>)</h3><p>Returns the element's first child.</p>
<p><b>See also</b> <a href="qwebelement.html#lastChild">lastChild</a>(), <a href="qwebelement.html#previousSibling">previousSibling</a>(), and
<a href="qwebelement.html#nextSibling">nextSibling</a>().</p>


<h3 class="fn"><a name="geometry" /><a href="qrect.html">QRect</a> QWebElement.geometry (<i>self</i>)</h3><p>Returns the geometry of this element, relative to its containing
frame.</p>
<p><b>See also</b> <a href="qwebelement.html#tagName">tagName</a>().</p>


<h3 class="fn"><a name="hasAttribute" />bool QWebElement.hasAttribute (<i>self</i>, QString&#160;<i>name</i>)</h3><p>Returns true if this element has an attribute with the given
<i>name</i>; otherwise returns false.</p>
<p><b>See also</b> <a href="qwebelement.html#attribute">attribute</a>() and <a href="qwebelement.html#setAttribute">setAttribute</a>().</p>


<h3 class="fn"><a name="hasAttributeNS" />bool QWebElement.hasAttributeNS (<i>self</i>, QString&#160;<i>namespaceUri</i>, QString&#160;<i>name</i>)</h3><p>Returns true if this element has an attribute with the given
<i>name</i>, in <i>namespaceUri</i>; otherwise returns false.</p>
<p><b>See also</b> <a href="qwebelement.html#attributeNS">attributeNS</a>() and <a href="qwebelement.html#setAttributeNS">setAttributeNS</a>().</p>


<h3 class="fn"><a name="hasAttributes" />bool QWebElement.hasAttributes (<i>self</i>)</h3><p>Returns true if the element has any attributes defined;
otherwise returns false;</p>
<p><b>See also</b> <a href="qwebelement.html#attribute">attribute</a>() and <a href="qwebelement.html#setAttribute">setAttribute</a>().</p>


<h3 class="fn"><a name="hasClass" />bool QWebElement.hasClass (<i>self</i>, QString&#160;<i>name</i>)</h3><p>Returns true if this element has a class with the given
<i>name</i>; otherwise returns false.</p>


<h3 class="fn"><a name="hasFocus" />bool QWebElement.hasFocus (<i>self</i>)</h3><p>Returns true if the element has keyboard input focus; otherwise,
returns false</p>
<p><b>See also</b> <a href="qwebelement.html#setFocus">setFocus</a>().</p>


<h3 class="fn"><a name="isNull" />bool QWebElement.isNull (<i>self</i>)</h3><p>Returns true if the element is a null element; otherwise returns
false.</p>


<h3 class="fn"><a name="lastChild" /><a href="qwebelement.html">QWebElement</a> QWebElement.lastChild (<i>self</i>)</h3><p>Returns the element's last child.</p>
<p><b>See also</b> <a href="qwebelement.html#firstChild">firstChild</a>(), <a href="qwebelement.html#previousSibling">previousSibling</a>(), and
<a href="qwebelement.html#nextSibling">nextSibling</a>().</p>


<h3 class="fn"><a name="localName" />QString QWebElement.localName (<i>self</i>)</h3><p>Returns the local name of the element. If the element does not
use namespaces, an empty string is returned.</p>


<h3 class="fn"><a name="namespaceUri" />QString QWebElement.namespaceUri (<i>self</i>)</h3><p>Returns the namespace URI of this element. If the element has no
namespace URI, an empty string is returned.</p>


<h3 class="fn"><a name="nextSibling" /><a href="qwebelement.html">QWebElement</a> QWebElement.nextSibling (<i>self</i>)</h3><p>Returns the element's next sibling.</p>
<p><b>See also</b> <a href="qwebelement.html#firstChild">firstChild</a>(), <a href="qwebelement.html#previousSibling">previousSibling</a>(), and
<a href="qwebelement.html#lastChild">lastChild</a>().</p>


<h3 class="fn"><a name="parent" /><a href="qwebelement.html">QWebElement</a> QWebElement.parent (<i>self</i>)</h3><p>Returns the parent element of this elemen. If this element is
the root document element, a null element is returned.</p>


<h3 class="fn"><a name="prefix" />QString QWebElement.prefix (<i>self</i>)</h3><p>Returns the namespace prefix of the element. If the element has
no namespace prefix, empty string is returned.</p>


<h3 class="fn"><a name="prependInside" />QWebElement.prependInside (<i>self</i>, QString&#160;<i>markup</i>)</h3><p>Prepends the result of parsing <i>markup</i> as the element's
first child.</p>
<p>Calling this function on a null element does nothing.</p>
<p><b>See also</b> <a href="qwebelement.html#appendInside">appendInside</a>(), <a href="qwebelement.html#prependOutside">prependOutside</a>(), and
<a href="qwebelement.html#appendOutside">appendOutside</a>().</p>


<h3 class="fn"><a name="prependInside-2" />QWebElement.prependInside (<i>self</i>, <a href="qwebelement.html">QWebElement</a>&#160;<i>element</i>)</h3><p>Prepends <i>element</i> as the element's first child.</p>
<p>If <i>element</i> is the child of another element, it is
re-parented to this element. If <i>element</i> is a child of this
element, then its position in the list of children is changed.</p>
<p>Calling this function on a null element does nothing.</p>
<p><b>See also</b> <a href="qwebelement.html#appendInside">appendInside</a>(), <a href="qwebelement.html#prependOutside">prependOutside</a>(), and
<a href="qwebelement.html#appendOutside">appendOutside</a>().</p>


<h3 class="fn"><a name="prependOutside" />QWebElement.prependOutside (<i>self</i>, QString&#160;<i>markup</i>)</h3><p>Inserts the result of parsing <i>markup</i> before this
element.</p>
<p>Calling this function on a null element does nothing.</p>
<p><b>See also</b> <a href="qwebelement.html#appendInside">appendInside</a>(), <a href="qwebelement.html#prependInside">prependInside</a>(), and <a href="qwebelement.html#appendOutside">appendOutside</a>().</p>


<h3 class="fn"><a name="prependOutside-2" />QWebElement.prependOutside (<i>self</i>, <a href="qwebelement.html">QWebElement</a>&#160;<i>element</i>)</h3><p>Inserts the given <i>element</i> before this element.</p>
<p>If <i>element</i> is the child of another element, it is
re-parented to the parent of this element.</p>
<p>Calling this function on a null element does nothing.</p>
<p><b>See also</b> <a href="qwebelement.html#appendInside">appendInside</a>(), <a href="qwebelement.html#prependInside">prependInside</a>(), and <a href="qwebelement.html#appendOutside">appendOutside</a>().</p>


<h3 class="fn"><a name="previousSibling" /><a href="qwebelement.html">QWebElement</a> QWebElement.previousSibling (<i>self</i>)</h3><p>Returns the element's previous sibling.</p>
<p><b>See also</b> <a href="qwebelement.html#firstChild">firstChild</a>(), <a href="qwebelement.html#nextSibling">nextSibling</a>(), and <a href="qwebelement.html#lastChild">lastChild</a>().</p>


<h3 class="fn"><a name="removeAllChildren" />QWebElement.removeAllChildren (<i>self</i>)</h3><p>Removes all children from this element.</p>
<p><b>See also</b> <a href="qwebelement.html#removeFromDocument">removeFromDocument</a>() and
<a href="qwebelement.html#takeFromDocument">takeFromDocument</a>().</p>


<h3 class="fn"><a name="removeAttribute" />QWebElement.removeAttribute (<i>self</i>, QString&#160;<i>name</i>)</h3><p>Removes the attribute with the given <i>name</i> from this
element.</p>
<p><b>See also</b> <a href="qwebelement.html#attribute">attribute</a>(), <a href="qwebelement.html#setAttribute">setAttribute</a>(), and <a href="qwebelement.html#hasAttribute">hasAttribute</a>().</p>


<h3 class="fn"><a name="removeAttributeNS" />QWebElement.removeAttributeNS (<i>self</i>, QString&#160;<i>namespaceUri</i>, QString&#160;<i>name</i>)</h3><p>Removes the attribute with the given <i>name</i>, in
<i>namespaceUri</i>, from this element.</p>
<p><b>See also</b> <a href="qwebelement.html#attributeNS">attributeNS</a>(), <a href="qwebelement.html#setAttributeNS">setAttributeNS</a>(), and
<a href="qwebelement.html#hasAttributeNS">hasAttributeNS</a>().</p>


<h3 class="fn"><a name="removeClass" />QWebElement.removeClass (<i>self</i>, QString&#160;<i>name</i>)</h3><p>Removes the specified class with the given <i>name</i> from the
element.</p>


<h3 class="fn"><a name="removeFromDocument" />QWebElement.removeFromDocument (<i>self</i>)</h3><p>Removes this element from the document and makes it a null
element.</p>
<p><b>See also</b> <a href="qwebelement.html#removeAllChildren">removeAllChildren</a>() and
<a href="qwebelement.html#takeFromDocument">takeFromDocument</a>().</p>


<h3 class="fn"><a name="render" />QWebElement.render (<i>self</i>, <a href="qpainter.html">QPainter</a>&#160;<i>painter</i>)</h3><p>Render the element into <i>painter</i> .</p>


<h3 class="fn"><a name="replace" />QWebElement.replace (<i>self</i>, QString&#160;<i>markup</i>)</h3><p>Replaces this element with the result of parsing
<i>markup</i>.</p>
<p>This method will not replace the &lt;html&gt;, &lt;head&gt; or
&lt;body&gt; elements.</p>
<p><b>See also</b> <a href="qwebelement.html#encloseWith">encloseWith</a>().</p>


<h3 class="fn"><a name="replace-2" />QWebElement.replace (<i>self</i>, <a href="qwebelement.html">QWebElement</a>&#160;<i>element</i>)</h3><p>Replaces this element with <i>element</i>.</p>
<p>This method will not replace the &lt;html&gt;, &lt;head&gt; or
&lt;body&gt; elements.</p>
<p><b>See also</b> <a href="qwebelement.html#encloseWith">encloseWith</a>().</p>


<h3 class="fn"><a name="setAttribute" />QWebElement.setAttribute (<i>self</i>, QString&#160;<i>name</i>, QString&#160;<i>value</i>)</h3><p>Adds an attribute with the given <i>name</i> and <i>value</i>.
If an attribute with the same name exists, its value is replaced by
<i>value</i>.</p>
<p><b>See also</b> <a href="qwebelement.html#attribute">attribute</a>(), <a href="qwebelement.html#attributeNS">attributeNS</a>(), and <a href="qwebelement.html#setAttributeNS">setAttributeNS</a>().</p>


<h3 class="fn"><a name="setAttributeNS" />QWebElement.setAttributeNS (<i>self</i>, QString&#160;<i>namespaceUri</i>, QString&#160;<i>name</i>, QString&#160;<i>value</i>)</h3><p>Adds an attribute with the given <i>name</i> in
<i>namespaceUri</i> with <i>value</i>. If an attribute with the
same name exists, its value is replaced by <i>value</i>.</p>
<p><b>See also</b> <a href="qwebelement.html#attributeNS">attributeNS</a>(), <a href="qwebelement.html#attribute">attribute</a>(), and <a href="qwebelement.html#setAttribute">setAttribute</a>().</p>


<h3 class="fn"><a name="setFocus" />QWebElement.setFocus (<i>self</i>)</h3><p>Gives keyboard input focus to this element</p>
<p><b>See also</b> <a href="qwebelement.html#hasFocus">hasFocus</a>().</p>


<h3 class="fn"><a name="setInnerXml" />QWebElement.setInnerXml (<i>self</i>, QString&#160;<i>markup</i>)</h3><p>Replaces the contents of this element with <i>markup</i>. The
string may contain HTML or XML tags, which is parsed and formatted
before insertion into the document.</p>
<p><b>Note:</b> This is currently implemented for (X)HTML elements
only.</p>
<p><b>See also</b> <a href="qwebelement.html#toInnerXml">toInnerXml</a>(), <a href="qwebelement.html#toOuterXml">toOuterXml</a>(), and <a href="qwebelement.html#setOuterXml">setOuterXml</a>().</p>


<h3 class="fn"><a name="setOuterXml" />QWebElement.setOuterXml (<i>self</i>, QString&#160;<i>markup</i>)</h3><p>Replaces the contents of this element as well as its own tag
with <i>markup</i>. The string may contain HTML or XML tags, which
is parsed and formatted before insertion into the document.</p>
<p><b>Note:</b> This is currently only implemented for (X)HTML
elements.</p>
<p><b>See also</b> <a href="qwebelement.html#toOuterXml">toOuterXml</a>(), <a href="qwebelement.html#toInnerXml">toInnerXml</a>(), and <a href="qwebelement.html#setInnerXml">setInnerXml</a>().</p>


<h3 class="fn"><a name="setPlainText" />QWebElement.setPlainText (<i>self</i>, QString&#160;<i>text</i>)</h3><p>Replaces the existing content of this element with
<i>text</i>.</p>
<p>This is equivalent to setting the HTML innerText property.</p>
<p><b>See also</b> <a href="qwebelement.html#toPlainText">toPlainText</a>().</p>


<h3 class="fn"><a name="setStyleProperty" />QWebElement.setStyleProperty (<i>self</i>, QString&#160;<i>name</i>, QString&#160;<i>value</i>)</h3><p>Sets the value of the inline style with the given <i>name</i> to
<i>value</i>.</p>
<p>Setting a value, does not necessarily mean that it will become
the applied value, due to the fact that the style property's value
might have been set earlier with a higher priority in external or
embedded style declarations.</p>
<p>In order to ensure that the value will be applied, you may have
to append "!important" to the value.</p>
<p><b>See also</b> <a href="qwebelement.html#styleProperty">styleProperty</a>().</p>


<h3 class="fn"><a name="styleProperty" />QString QWebElement.styleProperty (<i>self</i>, QString&#160;<i>name</i>, <a href="qwebelement.html#StyleResolveStrategy-enum">StyleResolveStrategy</a>&#160;<i>strategy</i>)</h3><p>Returns the value of the style with the given <i>name</i> using
the specified <i>strategy</i>. If a style with <i>name</i> does not
exist, an empty string is returned.</p>
<p>In CSS, the cascading part depends on which CSS rule has
priority and is thus applied. Generally, the last defined rule has
priority. Thus, an inline style rule has priority over an embedded
block style rule, which in return has priority over an external
style rule.</p>
<p>If the "!important" declaration is set on one of those, the
declaration receives highest priority, unless other declarations
also use the "!important" declaration. Then, the last "!important"
declaration takes predecence.</p>
<p><b>See also</b> <a href="qwebelement.html#setStyleProperty">setStyleProperty</a>().</p>


<h3 class="fn"><a name="tagName" />QString QWebElement.tagName (<i>self</i>)</h3><p>Returns the tag name of this element.</p>
<p><b>See also</b> <a href="qwebelement.html#geometry">geometry</a>().</p>


<h3 class="fn"><a name="takeFromDocument" /><a href="qwebelement.html">QWebElement</a> QWebElement.takeFromDocument (<i>self</i>)</h3><p>Removes this element from the document and returns a reference
to it.</p>
<p>The element is still valid after removal, and can be inserted
into other parts of the document.</p>
<p><b>See also</b> <a href="qwebelement.html#removeAllChildren">removeAllChildren</a>() and
<a href="qwebelement.html#removeFromDocument">removeFromDocument</a>().</p>


<h3 class="fn"><a name="toggleClass" />QWebElement.toggleClass (<i>self</i>, QString&#160;<i>name</i>)</h3><p>Adds the specified class with the given <i>name</i> if it is not
present. If the class is already present, it will be removed.</p>


<h3 class="fn"><a name="toInnerXml" />QString QWebElement.toInnerXml (<i>self</i>)</h3><p>Returns the XML content between the element's start and end
tags.</p>
<p><b>Note:</b> This is currently implemented for (X)HTML elements
only.</p>
<p><b>Note:</b> The format of the markup returned will obey the
namespace of the document containing the element. This means the
return value will obey XML formatting rules, such as self-closing
tags, only if the document is 'text/xhtml+xml'.</p>
<p><b>See also</b> <a href="qwebelement.html#setInnerXml">setInnerXml</a>(), <a href="qwebelement.html#setOuterXml">setOuterXml</a>(), and <a href="qwebelement.html#toOuterXml">toOuterXml</a>().</p>


<h3 class="fn"><a name="toOuterXml" />QString QWebElement.toOuterXml (<i>self</i>)</h3><p>Returns this element converted to XML, including the start and
the end tags as well as its attributes.</p>
<p><b>Note:</b> This is currently implemented for (X)HTML elements
only.</p>
<p><b>Note:</b> The format of the markup returned will obey the
namespace of the document containing the element. This means the
return value will obey XML formatting rules, such as self-closing
tags, only if the document is 'text/xhtml+xml'.</p>
<p><b>See also</b> <a href="qwebelement.html#setOuterXml">setOuterXml</a>(), <a href="qwebelement.html#setInnerXml">setInnerXml</a>(), and <a href="qwebelement.html#toInnerXml">toInnerXml</a>().</p>


<h3 class="fn"><a name="toPlainText" />QString QWebElement.toPlainText (<i>self</i>)</h3><p>Returns the text between the start and the end tag of this
element.</p>
<p>This is equivalent to reading the HTML innerText property.</p>
<p><b>See also</b> <a href="qwebelement.html#setPlainText">setPlainText</a>().</p>


<h3 class="fn"><a name="webFrame" /><a href="qwebframe.html">QWebFrame</a> QWebElement.webFrame (<i>self</i>)</h3><p>Returns the web frame which this element is a part of. If the
element is a null element, null is returned.</p>


<h3 class="fn"><a name="__eq__" />bool QWebElement.__eq__ (<i>self</i>, <a href="qwebelement.html">QWebElement</a>&#160;<i>o</i>)</h3><h3 class="fn"><a name="__ne__" />bool QWebElement.__ne__ (<i>self</i>, <a href="qwebelement.html">QWebElement</a>&#160;<i>o</i>)</h3><address><hr /><div align="center"><table border="0" cellspacing="0" width="100%"><tr class="address"><td align="left" width="25%">PyQt&#160;4.9.1 for X11</td><td align="center" width="50%">Copyright &#169; <a href="http://www.riverbankcomputing.com">Riverbank&#160;Computing&#160;Ltd</a> and <a href="http://www.qtsoftware.com">Nokia</a> 2011</td><td align="right" width="25%">Qt&#160;4.8.0</td></tr></table></div></address></body></html>